package com.yu.demo.user.domain.repository;

import com.yu.demo.user.domain.entity.User;
import com.yu.demo.user.domain.valueobject.Email;
import com.yu.demo.user.domain.valueobject.UserId;
import com.yu.demo.user.domain.valueobject.Username;

import java.util.List;
import java.util.Optional;

/**
 * 用户仓储接口
 * 定义用户实体的持久化操作契约
 */
public interface UserRepository {
    
    /**
     * 保存用户
     */
    User save(User user);
    
    /**
     * 根据ID查找用户
     */
    Optional<User> findById(UserId id);
    
    /**
     * 根据用户名查找用户
     */
    Optional<User> findByUsername(Username username);
    
    /**
     * 根据邮箱查找用户
     */
    Optional<User> findByEmail(Email email);
    
    /**
     * 查找所有用户
     */
    List<User> findAll();
    
    /**
     * 查找所有激活的用户
     */
    List<User> findAllActive();
    
    /**
     * 根据角色查找用户
     */
    List<User> findByRole(String role);
    
    /**
     * 删除用户
     */
    void delete(UserId id);
    
    /**
     * 检查用户名是否存在
     */
    boolean existsByUsername(Username username);
    
    /**
     * 检查邮箱是否存在
     */
    boolean existsByEmail(Email email);
    
    /**
     * 统计用户总数
     */
    long count();
    
    /**
     * 统计激活用户数
     */
    long countActive();
}
